skype4py.api.windows-pysrc.html

基于python的skype的API的说明文档

<a name="L138"></a><tt class="py-lineno">138</tt>  <tt class="py-line">                                                     <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">hwnd</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">,</tt> <tt class="py-number">5000</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L139"></a><tt class="py-lineno">139</tt>  <tt class="py-line">                <tt class="py-keyword">raise</tt> <tt id="link-28" class="py-name"><a title="Skype4Py.errors.ISkypeAPIError" class="py-name" href="#" onclick="return doclink('link-28', 'ISkypeAPIError', 'link-7');">ISkypeAPIError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Could not broadcast Skype discover message'</tt><tt class="py-op">)</tt> </tt>
<a name="L140"></a><tt class="py-lineno">140</tt>  <tt class="py-line">            <tt class="py-comment"># wait (with timeout) till the WindProc() attaches</tt> </tt>
<a name="L141"></a><tt class="py-lineno">141</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">Wait</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L142"></a><tt class="py-lineno">142</tt>  <tt class="py-line">            <tt class="py-name">t</tt> <tt class="py-op">=</tt> <tt class="py-name">threading</tt><tt class="py-op">.</tt><tt class="py-name">Timer</tt><tt class="py-op">(</tt><tt id="link-29" class="py-name" targets="Variable Skype4Py.skype.ISkype.Timeout=Skype4Py.skype.ISkype-class.html#Timeout"><a title="Skype4Py.skype.ISkype.Timeout" class="py-name" href="#" onclick="return doclink('link-29', 'Timeout', 'link-29');">Timeout</a></tt> <tt class="py-op">/</tt> <tt class="py-number">1000</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__Attach_ftimeout</tt><tt class="py-op">)</tt> </tt>
<a name="L143"></a><tt class="py-lineno">143</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">Wait</tt><tt class="py-op">:</tt> </tt>
<a name="L144"></a><tt class="py-lineno">144</tt>  <tt class="py-line">                <tt class="py-name">t</tt><tt class="py-op">.</tt><tt class="py-name">start</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L145"></a><tt class="py-lineno">145</tt>  <tt class="py-line">            <tt class="py-keyword">while</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">Wait</tt> <tt class="py-keyword">and</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name" targets="Variable Skype4Py.skype.ISkype.AttachmentStatus=Skype4Py.skype.ISkype-class.html#AttachmentStatus,Method Skype4Py.skype.ISkypeEvents.AttachmentStatus()=Skype4Py.skype.ISkypeEvents-class.html#AttachmentStatus"><a title="Skype4Py.skype.ISkype.AttachmentStatus
Skype4Py.skype.ISkypeEvents.AttachmentStatus" class="py-name" href="#" onclick="return doclink('link-30', 'AttachmentStatus', 'link-30');">AttachmentStatus</a></tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt id="link-31" class="py-name" targets="Variable Skype4Py.enums.apiAttachSuccess=Skype4Py.enums-module.html#apiAttachSuccess"><a title="Skype4Py.enums.apiAttachSuccess" class="py-name" href="#" onclick="return doclink('link-31', 'apiAttachSuccess', 'link-31');">apiAttachSuccess</a></tt><tt class="py-op">,</tt> <tt id="link-32" class="py-name" targets="Variable Skype4Py.enums.apiAttachRefused=Skype4Py.enums-module.html#apiAttachRefused"><a title="Skype4Py.enums.apiAttachRefused" class="py-name" href="#" onclick="return doclink('link-32', 'apiAttachRefused', 'link-32');">apiAttachRefused</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L146"></a><tt class="py-lineno">146</tt>  <tt class="py-line">                <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-33" class="py-name"><a title="Skype4Py.skype.ISkype.AttachmentStatus
Skype4Py.skype.ISkypeEvents.AttachmentStatus" class="py-name" href="#" onclick="return doclink('link-33', 'AttachmentStatus', 'link-30');">AttachmentStatus</a></tt> <tt class="py-op">==</tt> <tt id="link-34" class="py-name" targets="Variable Skype4Py.enums.apiAttachPendingAuthorization=Skype4Py.enums-module.html#apiAttachPendingAuthorization"><a title="Skype4Py.enums.apiAttachPendingAuthorization" class="py-name" href="#" onclick="return doclink('link-34', 'apiAttachPendingAuthorization', 'link-34');">apiAttachPendingAuthorization</a></tt><tt class="py-op">:</tt> </tt>
<a name="L147"></a><tt class="py-lineno">147</tt>  <tt class="py-line">                    <tt class="py-comment"># disable the timeout</tt> </tt>
<a name="L148"></a><tt class="py-lineno">148</tt>  <tt class="py-line">                    <tt class="py-name">t</tt><tt class="py-op">.</tt><tt class="py-name">cancel</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L149"></a><tt class="py-lineno">149</tt>  <tt class="py-line">                <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-35" class="py-name"><a title="Skype4Py.skype.ISkype.AttachmentStatus
Skype4Py.skype.ISkypeEvents.AttachmentStatus" class="py-name" href="#" onclick="return doclink('link-35', 'AttachmentStatus', 'link-30');">AttachmentStatus</a></tt> <tt class="py-op">==</tt> <tt id="link-36" class="py-name" targets="Variable Skype4Py.enums.apiAttachAvailable=Skype4Py.enums-module.html#apiAttachAvailable"><a title="Skype4Py.enums.apiAttachAvailable" class="py-name" href="#" onclick="return doclink('link-36', 'apiAttachAvailable', 'link-36');">apiAttachAvailable</a></tt><tt class="py-op">:</tt> </tt>
<a name="L150"></a><tt class="py-lineno">150</tt>  <tt class="py-line">                    <tt class="py-comment"># rebroadcast</tt> </tt>
<a name="L151"></a><tt class="py-lineno">151</tt>  <tt class="py-line">                    <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">DebugPrint</tt><tt class="py-op">(</tt><tt class="py-string">'-&gt;'</tt><tt class="py-op">,</tt> <tt class="py-string">'SkypeControlAPIDiscover'</tt><tt class="py-op">)</tt> </tt>
<a name="L152"></a><tt class="py-lineno">152</tt>  <tt class="py-line">                    <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">user32</tt><tt class="py-op">.</tt><tt class="py-name">SetForegroundWindow</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">hwnd</tt><tt class="py-op">)</tt> </tt>
<a name="L153"></a><tt class="py-lineno">153</tt>  <tt class="py-line">                    <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">user32</tt><tt class="py-op">.</tt><tt class="py-name">SendMessageTimeoutA</tt><tt class="py-op">(</tt><tt id="link-37" class="py-name"><a title="Skype4Py.API.windows._HWND_BROADCAST" class="py-name" href="#" onclick="return doclink('link-37', '_HWND_BROADCAST', 'link-18');">_HWND_BROADCAST</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_SkypeControlAPIDiscover</tt><tt class="py-op">,</tt> </tt>
<a name="L154"></a><tt class="py-lineno">154</tt>  <tt class="py-line">                                                             <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">hwnd</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">,</tt> <tt class="py-number">5000</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L155"></a><tt class="py-lineno">155</tt>  <tt class="py-line">                        <tt class="py-keyword">raise</tt> <tt id="link-38" class="py-name"><a title="Skype4Py.errors.ISkypeAPIError" class="py-name" href="#" onclick="return doclink('link-38', 'ISkypeAPIError', 'link-7');">ISkypeAPIError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Could not broadcast Skype discover message'</tt><tt class="py-op">)</tt> </tt>
<a name="L156"></a><tt class="py-lineno">156</tt>  <tt class="py-line">                <tt class="py-name">time</tt><tt class="py-op">.</tt><tt class="py-name">sleep</tt><tt class="py-op">(</tt><tt class="py-number">0.01</tt><tt class="py-op">)</tt> </tt>
<a name="L157"></a><tt class="py-lineno">157</tt>  <tt class="py-line">            <tt class="py-name">t</tt><tt class="py-op">.</tt><tt class="py-name">cancel</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L158"></a><tt class="py-lineno">158</tt>  <tt class="py-line">        <tt class="py-keyword">finally</tt><tt class="py-op">:</tt> </tt>
<a name="L159"></a><tt class="py-lineno">159</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">fhwnd</tt><tt class="py-op">:</tt> </tt>
<a name="L160"></a><tt class="py-lineno">160</tt>  <tt class="py-line">                <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">user32</tt><tt class="py-op">.</tt><tt class="py-name">SetForegroundWindow</tt><tt class="py-op">(</tt><tt class="py-name">fhwnd</tt><tt class="py-op">)</tt> </tt>
<a name="L161"></a><tt class="py-lineno">161</tt>  <tt class="py-line">        <tt class="py-comment"># check if we got the Skype window's hwnd</tt> </tt>
<a name="L162"></a><tt class="py-lineno">162</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">Skype</tt><tt class="py-op">:</tt> </tt>
<a name="L163"></a><tt class="py-lineno">163</tt>  <tt class="py-line">            <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-39" class="py-name"><a title="Skype4Py.skype.ISkype.SendCommand" class="py-name" href="#" onclick="return doclink('link-39', 'SendCommand', 'link-23');">SendCommand</a></tt><tt class="py-op">(</tt><tt id="link-40" class="py-name"><a title="Skype4Py.API.ICommand" class="py-name" href="#" onclick="return doclink('link-40', 'ICommand', 'link-2');">ICommand</a></tt><tt class="py-op">(</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> <tt class="py-string">'PROTOCOL %s'</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-41" class="py-name" targets="Variable Skype4Py.skype.ISkype.Protocol=Skype4Py.skype.ISkype-class.html#Protocol"><a title="Skype4Py.skype.ISkype.Protocol" class="py-name" href="#" onclick="return doclink('link-41', 'Protocol', 'link-41');">Protocol</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L164"></a><tt class="py-lineno">164</tt>  <tt class="py-line">        <tt class="py-keyword">elif</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">Wait</tt><tt class="py-op">:</tt> </tt>
<a name="L165"></a><tt class="py-lineno">165</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt id="link-42" class="py-name"><a title="Skype4Py.errors.ISkypeAPIError" class="py-name" href="#" onclick="return doclink('link-42', 'ISkypeAPIError', 'link-7');">ISkypeAPIError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Skype attach timeout'</tt><tt class="py-op">)</tt> </tt>
</div><a name="L166"></a><tt class="py-lineno">166</tt>  <tt class="py-line"> </tt>
<a name="_ISkypeAPI.IsRunning"></a><div id="_ISkypeAPI.IsRunning-def"><a name="L167"></a><tt class="py-lineno">167</tt> <a class="py-toggle" href="#" id="_ISkypeAPI.IsRunning-toggle" onclick="return toggle('_ISkypeAPI.IsRunning');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="Skype4Py.API.windows._ISkypeAPI-class.html#IsRunning">IsRunning</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="_ISkypeAPI.IsRunning-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="_ISkypeAPI.IsRunning-expanded"><a name="L168"></a><tt class="py-lineno">168</tt>  <tt class="py-line">        <tt class="py-comment"># TZap is for Skype 4.0, tSk for 3.8 series</tt> </tt>
<a name="L169"></a><tt class="py-lineno">169</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">bool</tt><tt class="py-op">(</tt><tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">user32</tt><tt class="py-op">.</tt><tt class="py-name">FindWindowA</tt><tt class="py-op">(</tt><tt class="py-string">'TZapMainForm.UnicodeClass'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> \ </tt>
<a name="L170"></a><tt class="py-lineno">170</tt>  <tt class="py-line">            <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">user32</tt><tt class="py-op">.</tt><tt class="py-name">FindWindowA</tt><tt class="py-op">(</tt><tt class="py-string">'tSkMainForm.UnicodeClass'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L171"></a><tt class="py-lineno">171</tt>  <tt class="py-line"> </tt>
<a name="_ISkypeAPI.get_skype_path"></a><div id="_ISkypeAPI.get_skype_path-def"><a name="L172"></a><tt class="py-lineno">172</tt> <a class="py-toggle" href="#" id="_ISkypeAPI.get_skype_path-toggle" onclick="return toggle('_ISkypeAPI.get_skype_path');">-</a><tt class="py-line">    <tt class="py-keyword">def</tt> <a class="py-def-name" href="Skype4Py.API.windows._ISkypeAPI-class.html#get_skype_path">get_skype_path</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="_ISkypeAPI.get_skype_path-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="_ISkypeAPI.get_skype_path-expanded"><a name="L173"></a><tt class="py-lineno">173</tt>  <tt class="py-line">        <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt id="link-43" class="py-name"><a title="ctypes.c_long" class="py-name" href="#" onclick="return doclink('link-43', 'c_long', 'link-8');">c_long</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L174"></a><tt class="py-lineno">174</tt>  <tt class="py-line">        <tt class="py-comment"># try to find Skype in HKEY_CURRENT_USER registry tree</tt> </tt>
<a name="L175"></a><tt class="py-lineno">175</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">advapi32</tt><tt class="py-op">.</tt><tt class="py-name">RegOpenKeyA</tt><tt class="py-op">(</tt><tt class="py-number">0x80000001</tt><tt class="py-op">,</tt> <tt class="py-string">'Software\\Skype\\Phone'</tt><tt class="py-op">,</tt> <tt class="py-name">byref</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
<a name="L176"></a><tt class="py-lineno">176</tt>  <tt class="py-line">            <tt class="py-comment"># try to find Skype in HKEY_LOCAL_MACHINE registry tree</tt> </tt>
<a name="L177"></a><tt class="py-lineno">177</tt>  <tt class="py-line">            <tt class="py-keyword">if</tt> <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">advapi32</tt><tt class="py-op">.</tt><tt class="py-name">RegOpenKeyA</tt><tt class="py-op">(</tt><tt class="py-number">0x80000002</tt><tt class="py-op">,</tt> <tt class="py-string">'Software\\Skype\\Phone'</tt><tt class="py-op">,</tt> <tt class="py-name">byref</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
<a name="L178"></a><tt class="py-lineno">178</tt>  <tt class="py-line">                <tt class="py-keyword">raise</tt> <tt id="link-44" class="py-name"><a title="Skype4Py.errors.ISkypeAPIError" class="py-name" href="#" onclick="return doclink('link-44', 'ISkypeAPIError', 'link-7');">ISkypeAPIError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Skype not installed'</tt><tt class="py-op">)</tt> </tt>
<a name="L179"></a><tt class="py-lineno">179</tt>  <tt class="py-line">        <tt class="py-name">pathlen</tt> <tt class="py-op">=</tt> <tt id="link-45" class="py-name"><a title="ctypes.c_long" class="py-name" href="#" onclick="return doclink('link-45', 'c_long', 'link-8');">c_long</a></tt><tt class="py-op">(</tt><tt class="py-number">512</tt><tt class="py-op">)</tt> </tt>
<a name="L180"></a><tt class="py-lineno">180</tt>  <tt class="py-line">        <tt class="py-name">path</tt> <tt class="py-op">=</tt> <tt class="py-name">create_string_buffer</tt><tt class="py-op">(</tt><tt class="py-name">pathlen</tt><tt class="py-op">.</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L181"></a><tt class="py-lineno">181</tt>  <tt class="py-line">        <tt class="py-keyword">if</tt> <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">advapi32</tt><tt class="py-op">.</tt><tt class="py-name">RegQueryValueExA</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-string">'SkypePath'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-name">path</tt><tt class="py-op">,</tt> <tt class="py-name">byref</tt><tt class="py-op">(</tt><tt class="py-name">pathlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
<a name="L182"></a><tt class="py-lineno">182</tt>  <tt class="py-line">            <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">advapi32</tt><tt class="py-op">.</tt><tt class="py-name">RegCloseKey</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L183"></a><tt class="py-lineno">183</tt>  <tt class="py-line">            <tt class="py-keyword">raise</tt> <tt id="link-46" class="py-name"><a title="Skype4Py.errors.ISkypeAPIError" class="py-name" href="#" onclick="return doclink('link-46', 'ISkypeAPIError', 'link-7');">ISkypeAPIError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Cannot find Skype path'</tt><tt class="py-op">)</tt> </tt>
<a name="L184"></a><tt class="py-lineno">184</tt>  <tt class="py-line">        <tt class="py-name">windll</tt><tt class="py-op">.</tt><tt class="py-name">advapi32</tt><tt class="py-op">.</tt><tt class="py-name">RegCloseKey</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L185"></a><tt class="py-lineno">185</tt>  <tt class="py-line">        <tt class="py-keyword">return</tt> <tt class="py-name">path</tt><tt class="py-op">.</tt><tt class="py-name">value</tt> </tt>
</div><a name="L186"></a><tt class="py-lineno">186</tt>  <tt class="py-line"> </tt>
<a name="_ISkypeAPI.Start"></a><div id="_ISkypeAPI.Start-def"><a name="L187"></a><tt class="py-lineno">187</tt> <a class="py-toggle" href="#" id="_ISkyp