ISCPSecureQuery3::GetRightsOnClearChannel-Methode (mswmdm.h)
Die GetRightsOnClearChannel-Methode ruft Rechteinformationen für den aktuellen Inhalt in einem clear-Kanal ab.
Syntax
HRESULT GetRightsOnClearChannel(
[in] BYTE *pData,
[in] DWORD dwSize,
[in] BYTE *pbSPSessionKey,
[in] DWORD dwSessionKeyLen,
[in] IMDSPStorageGlobals *pStgGlobals,
[in] IWMDMProgress3 *pProgressCallback,
[out] PWMDMRIGHTS *ppRights,
[out] UINT *pnRightsCount
);
Parameter
[in] pData
Zeiger auf das Datenobjekt.
[in] dwSize
Anzahl der Bytes der Daten im pData-Puffer .
[in] pbSPSessionKey
Zeiger auf ein Bytearray, das den Sitzungsschlüssel zum Sichern der Kommunikation mit dem Dienstanbieter enthält, auf den pStgGlobals verweist.
[in] dwSessionKeyLen
Länge des Bytearrays, auf das pbSPSessionKey verweist.
[in] pStgGlobals
Zeiger auf eine IWMDMStorageGlobals-Schnittstelle im Stammspeicher des Mediums oder Geräts, auf das bzw. von dem die Datei übertragen wird.
[in] pProgressCallback
Zeiger auf eine IWMDMProgress3-Schnittstelle .
[out] ppRights
Zeiger auf ein Array von WMDMRIGHTS-Strukturen , die die Rechteinformationen für dieses Objekt enthalten. Das Array wird von dieser Methode zugeordnet und muss mithilfe von CoTaskMemFree freigegeben werden.
[out] pnRightsCount
Anzahl der WMDMRIGHTS-Strukturen im ppRights-Array .
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.
Rückgabecode | Beschreibung |
---|---|
|
Diese Methode wurde außerhalb der Reihenfolge aufgerufen. ISCPSecureQuery::GetDataDemands und dann ISCPSecureQuery::ExamineData müssen in dieser Reihenfolge aufgerufen werden. |
|
Der Nachrichtenauthentifizierungscode ist ungültig. |
|
Der Aufrufer verfügt nicht über die erforderlichen Rechte, um den angeforderten Vorgang auszuführen. |
|
Ein Parameter ist ungültig oder ein NULL-Zeiger . |
|
Es ist ein unbekannter Fehler aufgetreten. |
Hinweise
Diese Methode ist identisch mit ISCPSecureQuery::GetRights , mit der Ausnahme, dass die an diese Methode übergebenen Parameter nicht verschlüsselt sind. Folglich ist diese Methode effizienter.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | mswmdm.h |
Bibliothek | Mssachlp.lib |
Weitere Informationen
ISCPSecureQuery3-Schnittstelle