Freigeben über


IEnroll2::GetAlgNameWStr-Methode (xenroll.h)

[Diese Methode steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die GetAlgNameWStr-Methode ruft den Namen eines kryptografischen Algorithmus unter Berücksichtigung seiner ID ab. Die von dieser Methode abgerufenen Werte hängen vom aktuellen Kryptografiedienstanbieter (CSP) ab. Diese Methode wurde zuerst in der IEnroll2-Schnittstelle definiert.

Syntax

HRESULT GetAlgNameWStr(
  [in]  LONG   algID,
  [out] LPWSTR *ppwsz
);

Parameter

[in] algID

Wert, der einen kryptografischen Algorithmus darstellt, wie in Wincrypt.h definiert. Beispielsweise ist CALG_MD2 ein definierter Algorithmusbezeichner. Damit diese Methode erfolgreich ist, muss der aktuelle CSP den algID-Algorithmus unterstützen.

[out] ppwsz

Zeigen Sie bei Erfolg auf eine LPWSTR , die den Namen des von algID angegebenen Algorithmus darstellt.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an. Wenn ein CSP diese Methode nicht unterstützt oder den kryptografischen Algorithmus algID nicht unterstützt, wird ein Fehler zurückgegeben.

Hinweise

Diese Methode kann verwendet werden, um die Namen von Algorithmen anzuzeigen, deren IDs durch aufrufen von EnumAlgs abgerufen werden.

Konstanten für die kryptografischen Algorithmen werden in Wincrypt.h definiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile xenroll.h
Bibliothek Uuid.lib
DLL Xenroll.dll

Weitere Informationen

IEnroll2