admin/hakril-PythonForWindows
1
0
Fork 0
mirror of https://github.com/hakril/PythonForWindows synced 2026-06-08 14:31:45 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
8fa8cf9be182fc19aaf7ecb76a2906ebc8db1475
hakril-PythonForWindows/docs/build/html/wintrust.html
T
hakril 8fa8cf9be1 Regenerating documentation for 1.0.4
2025-08-14 10:37:06 +02:00

239 lines
16 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="en" data-content_root="./">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>8. windows.wintrust – Checking signature &#8212; PythonForWindows 1.0.4 documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="_static/classic.css?v=def86cc0" />
<link rel="stylesheet" type="text/css" href="_static/css/mbasic.css?v=957880af" />
<script src="_static/documentation_options.js?v=71272d9f"></script>
<script src="_static/doctools.js?v=9a2dae69"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="9. windows.debug – Debugging" href="debug.html" />
<link rel="prev" title="7. windows.utils – Windows Utilities" href="utils.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="debug.html" title="9. windows.debug – Debugging"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="utils.html" title="7. windows.utils – Windows Utilities"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">PythonForWindows 1.0.4 documentation</a> &#187;</li>
<li class="nav-item nav-item-this"><a href=""><span class="section-number">8. </span><code class="docutils literal notranslate"><span class="pre">windows.wintrust</span></code> – Checking signature</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="module-windows.wintrust">
<span id="windows-wintrust-checking-signature"></span><h1><span class="section-number">8. </span><code class="docutils literal notranslate"><span class="pre">windows.wintrust</span></code> – Checking signature<a class="headerlink" href="#module-windows.wintrust" title="Link to this heading"></a></h1>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>See sample <a class="reference internal" href="sample.html#sample-wintrust"><span class="std std-ref">windows.wintrust</span></a></p>
</div>
<p>The <code class="xref py py-mod docutils literal notranslate"><span class="pre">wintrust</span></code> module offers wrapper around <code class="docutils literal notranslate"><span class="pre">wintrust.dll</span></code>.
It allows to check the signature of a file.</p>
<p>The signature of a file can be at two differents place:</p>
<blockquote>
<div><ul class="simple">
<li><p>In the file itself (<a class="reference internal" href="#windows.wintrust.check_signature" title="windows.wintrust.check_signature"><code class="xref py py-func docutils literal notranslate"><span class="pre">check_signature()</span></code></a>)</p></li>
<li><p>In a catalog file (<a class="reference internal" href="#windows.wintrust.full_signature_information" title="windows.wintrust.full_signature_information"><code class="xref py py-func docutils literal notranslate"><span class="pre">full_signature_information()</span></code></a>)</p></li>
</ul>
</div></blockquote>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><a class="reference external" href="https://msdn.microsoft.com/en-us/library/windows/hardware/ff537872(v=vs.85).aspx">Explanation about catalog files</a></p>
</div>
<section id="api">
<h2><span class="section-number">8.1. </span>API<a class="headerlink" href="#api" title="Link to this heading"></a></h2>
<dl class="py function">
<dt class="sig sig-object py" id="windows.wintrust.is_signed">
<span class="sig-prename descclassname"><span class="pre">windows.wintrust.</span></span><span class="sig-name descname"><span class="pre">is_signed</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/windows/wintrust.html#is_signed"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#windows.wintrust.is_signed" title="Link to this definition"></a></dt>
<dd><p>Check if <code class="docutils literal notranslate"><span class="pre">filename</span></code> is signed:</p>
<blockquote>
<div><ul class="simple">
<li><p>File embeds a valid signature</p></li>
<li><p>File is part of a signed catalog file</p></li>
</ul>
</div></blockquote>
<dl class="field-list simple">
<dt class="field-odd">Returns<span class="colon">:</span></dt>
<dd class="field-odd"><p><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></p>
</dd>
</dl>
</dd></dl>
<dl class="py function">
<dt class="sig sig-object py" id="windows.wintrust.full_signature_information">
<span class="sig-prename descclassname"><span class="pre">windows.wintrust.</span></span><span class="sig-name descname"><span class="pre">full_signature_information</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/windows/wintrust.html#full_signature_information"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#windows.wintrust.full_signature_information" title="Link to this definition"></a></dt>
<dd><p>Returns more information about the signature of <code class="docutils literal notranslate"><span class="pre">filename</span></code></p>
<dl class="field-list simple">
<dt class="field-odd">Returns<span class="colon">:</span></dt>
<dd class="field-odd"><p><a class="reference internal" href="#windows.wintrust.SignatureData" title="windows.wintrust.SignatureData"><code class="xref py py-class docutils literal notranslate"><span class="pre">SignatureData</span></code></a></p>
</dd>
</dl>
</dd></dl>
<dl class="py function">
<dt class="sig sig-object py" id="windows.wintrust.check_signature">
<span class="sig-prename descclassname"><span class="pre">windows.wintrust.</span></span><span class="sig-name descname"><span class="pre">check_signature</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/windows/wintrust.html#check_signature"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#windows.wintrust.check_signature" title="Link to this definition"></a></dt>
<dd><p>Check if <code class="docutils literal notranslate"><span class="pre">filename</span></code> embeds a valid signature.</p>
<dl class="field-list simple">
<dt class="field-odd">Returns<span class="colon">:</span></dt>
<dd class="field-odd"><p><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code>: <code class="docutils literal notranslate"><span class="pre">0</span></code> if <code class="docutils literal notranslate"><span class="pre">filename</span></code> have a valid signature else the error</p>
</dd>
</dl>
</dd></dl>
<section id="signaturedata">
<h3><span class="section-number">8.1.1. </span>SignatureData<a class="headerlink" href="#signaturedata" title="Link to this heading"></a></h3>
<dl class="py class">
<dt class="sig sig-object py" id="windows.wintrust.SignatureData">
<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">windows.wintrust.</span></span><span class="sig-name descname"><span class="pre">SignatureData</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">signed</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">catalog</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">catalogsigned</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">additionalinfo</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#windows.wintrust.SignatureData" title="Link to this definition"></a></dt>
<dd><p>Signature information for <code class="docutils literal notranslate"><span class="pre">FILENAME</span></code>:</p>
<blockquote>
<div><ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">signed</span></code>: True if <code class="docutils literal notranslate"><span class="pre">FILENAME</span></code> embeds a valide signature</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">catalog</span></code>: The filename of the catalog <code class="docutils literal notranslate"><span class="pre">FILENAME</span></code> is part of (if any)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">catalogsigned</span></code>: True if <code class="docutils literal notranslate"><span class="pre">catalog</span></code> embeds a valide signature</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">additionalinfo</span></code>: The return error of <code class="docutils literal notranslate"><span class="pre">check_signature(FILENAME)</span></code></p></li>
</ul>
</div></blockquote>
<p><code class="docutils literal notranslate"><span class="pre">additionalinfo</span></code> is useful to know if <code class="docutils literal notranslate"><span class="pre">FILENAME</span></code> signature was rejected for an invalid root / expired cert.</p>
<dl class="py attribute">
<dt class="sig sig-object py" id="windows.wintrust.SignatureData.additionalinfo">
<span class="sig-name descname"><span class="pre">additionalinfo</span></span><a class="headerlink" href="#windows.wintrust.SignatureData.additionalinfo" title="Link to this definition"></a></dt>
<dd><p>Alias for field number 3</p>
</dd></dl>
<dl class="py attribute">
<dt class="sig sig-object py" id="windows.wintrust.SignatureData.catalog">
<span class="sig-name descname"><span class="pre">catalog</span></span><a class="headerlink" href="#windows.wintrust.SignatureData.catalog" title="Link to this definition"></a></dt>
<dd><p>Alias for field number 1</p>
</dd></dl>
<dl class="py attribute">
<dt class="sig sig-object py" id="windows.wintrust.SignatureData.catalogsigned">
<span class="sig-name descname"><span class="pre">catalogsigned</span></span><a class="headerlink" href="#windows.wintrust.SignatureData.catalogsigned" title="Link to this definition"></a></dt>
<dd><p>Alias for field number 2</p>
</dd></dl>
<dl class="py attribute">
<dt class="sig sig-object py" id="windows.wintrust.SignatureData.signed">
<span class="sig-name descname"><span class="pre">signed</span></span><a class="headerlink" href="#windows.wintrust.SignatureData.signed" title="Link to this definition"></a></dt>
<dd><p>Alias for field number 0</p>
</dd></dl>
</dd></dl>
</section>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<div>
<h3><a href="index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">8. <code class="docutils literal notranslate"><span class="pre">windows.wintrust</span></code> – Checking signature</a><ul>
<li><a class="reference internal" href="#api">8.1. API</a><ul>
<li><a class="reference internal" href="#windows.wintrust.is_signed"><code class="docutils literal notranslate"><span class="pre">is_signed()</span></code></a></li>
<li><a class="reference internal" href="#windows.wintrust.full_signature_information"><code class="docutils literal notranslate"><span class="pre">full_signature_information()</span></code></a></li>
<li><a class="reference internal" href="#windows.wintrust.check_signature"><code class="docutils literal notranslate"><span class="pre">check_signature()</span></code></a></li>
<li><a class="reference internal" href="#signaturedata">8.1.1. SignatureData</a><ul>
<li><a class="reference internal" href="#windows.wintrust.SignatureData"><code class="docutils literal notranslate"><span class="pre">SignatureData</span></code></a><ul>
<li><a class="reference internal" href="#windows.wintrust.SignatureData.additionalinfo"><code class="docutils literal notranslate"><span class="pre">additionalinfo</span></code></a></li>
<li><a class="reference internal" href="#windows.wintrust.SignatureData.catalog"><code class="docutils literal notranslate"><span class="pre">catalog</span></code></a></li>
<li><a class="reference internal" href="#windows.wintrust.SignatureData.catalogsigned"><code class="docutils literal notranslate"><span class="pre">catalogsigned</span></code></a></li>
<li><a class="reference internal" href="#windows.wintrust.SignatureData.signed"><code class="docutils literal notranslate"><span class="pre">signed</span></code></a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="utils.html"
title="previous chapter"><span class="section-number">7. </span><code class="docutils literal notranslate"><span class="pre">windows.utils</span></code> – Windows Utilities</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="debug.html"
title="next chapter"><span class="section-number">9. </span><code class="xref py py-mod docutils literal notranslate"><span class="pre">windows.debug</span></code> – Debugging</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/wintrust.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="debug.html" title="9. windows.debug – Debugging"
>next</a> |</li>
<li class="right" >
<a href="utils.html" title="7. windows.utils – Windows Utilities"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">PythonForWindows 1.0.4 documentation</a> &#187;</li>
<li class="nav-item nav-item-this"><a href=""><span class="section-number">8. </span><code class="docutils literal notranslate"><span class="pre">windows.wintrust</span></code> – Checking signature</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2015-2020, Clement Rouault.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.3.7.
</div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink