IWMSecureChannel interface (wmsecure.h)
[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
[IWMSecureChannel is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Microsoft PlayReady. ]
The IWMSecureChannel interface provides methods that allow two DLLs to validate each other and perform secure communication.
Inheritance
The IWMSecureChannel interface inherits from IWMAuthorizer. IWMSecureChannel also has these types of members:
Methods
The IWMSecureChannel interface has these methods.
| IWMSecureChannel::WMSC_AddCertificate The WMSC_AddCertificate method adds certificates that this object can present to other secure channel objects. If no certs are added, then this object can only connect to objects with no signatures. |
| IWMSecureChannel::WMSC_AddSignature The WMSC_AddSignature method adds signatures that this object will look for when trying to connect. If no signatures are added, then this object will connect to any other object. |
| IWMSecureChannel::WMSC_Connect The WMSC_Connect method initializes the secure connection. |
| IWMSecureChannel::WMSC_Decrypt The WMSC_Decrypt method decrypts data across DLL boundaries. |
| IWMSecureChannel::WMSC_Disconnect The WMSC_Disconnect method destroys the secure connection. |
| IWMSecureChannel::WMSC_Encrypt The WMSC_Encrypt method encrypts data across DLL boundaries. |
| IWMSecureChannel::WMSC_GetValidCertificate The WMSC_GetValidCertificate method returns a copy of the certificate that was used provided by the other side of the connection. Also returns the index of the signature that validated that certificate. |
| IWMSecureChannel::WMSC_IsConnected The WMSC_IsConnected method checks to see if the secure connection is valid. |
| IWMSecureChannel::WMSC_Lock The WMSC_Lock method locks access to the secure connection. |
| IWMSecureChannel::WMSC_SetSharedData The WMSC_SetSharedData method is used during the connection negotiation process. |
| IWMSecureChannel::WMSC_Unlock The WMSC_Unlock method unlocks access to the secure connection. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | wmsecure.h |