ICertEncodeAltName::GetName-Methode (certenc.h)
Die GetName-Methode gibt den angegebenen Namen aus dem Array des alternativen Namens zurück.
Syntax
HRESULT GetName(
[in] LONG NameIndex,
[out] BSTR *pstrName
);
Parameter
[in] NameIndex
Ein nullbasierter Index, der den Index des abzurufenden alternativen Namenseintrags angibt.
Um den Objektbezeichner (OID) eines CERT_ALT_NAME_OTHER_NAME Namens abzurufen, kombinieren Sie den Indexwert mit EAN_NAMEOBJECTID (definiert als 0x80000000) mit einem bitweisen OR-Vorgang . Andernfalls wird der Binärwert abgerufen. Um den Typ des Namens zu bestimmen, rufen Sie die ICertEncodeAltName::GetNameChoice-Methode auf.
[out] pstrName
Ein Zeiger auf einen BSTR , der den alternativen Namen empfängt. Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
VB
Der Rückgabewert ist der alternative Name am angegebenen Index. Der Rückgabewert ist eine Unicode-Zeichenfolge .Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certenc.h (include Certsrv.h) |
| Bibliothek | Certidl.lib |
| DLL | Certenc.dll |