Metodo ICertEncodeAltName::GetNameChoice (certenc.h)

Articolo
08/22/2023

Il metodo GetNameChoice restituisce la scelta del nome in corrispondenza di un indice specificato di una matrice di nomi alternativi.

Sintassi

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

Parametri

[in] NameIndex

Specifica l'indice della voce del nome alternativo. La prima voce è in corrispondenza dell'indice zero.

[out] pNameChoice

Puntatore a un valore LONG che riceve l'identificatore di scelta del nome.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e il parametro pNameChoice punta a un valore che indica il tipo del nome alternativo. Si tratta di uno dei valori seguenti.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è la scelta del nome in corrispondenza dell'indice specificato. La scelta del nome indica il tipo del nome alternativo in modo che possa essere usato correttamente. Deve essere uno dei valori seguenti.

Codice restituito	Descrizione
CERT_ALT_NAME_DIRECTORY_NAME	Il nome è un nome di directory.
CERT_ALT_NAME_DNS_NAME	Il nome è una stringa IA5 che contiene un nome DNS (Domain Name System) nel formato Host.Entità.Dominio.
CERT_ALT_NAME_IP_ADDRESS	Il nome è una stringa ottetto che rappresenta un indirizzo del protocollo Internet.
CERT_ALT_NAME_REGISTERED_ID	Il nome è un identificatore di oggetto registrato (OID).
CERT_ALT_NAME_RFC822_NAME	Il nome è un indirizzo di posta elettronica.
CERT_ALT_NAME_URL	Il nome è una stringa IA5 che contiene un URL nel formato Service://HostName/Path.
CERT_ALT_NAME_OTHER_NAME	Il nome è costituito da un OID e da un BLOB binario.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenc.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certenc.dll

Vedi anche

ICertEncodeAltName

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry

Condividi tramite