Condividi tramite


Metodo ICertEncodeAltName::GetNameChoice (certenc.h)

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