Metodo ICertEncodeAltName::SetNameEntry (certenc.h)

Articolo
02/23/2024

Il metodo SetNameEntry imposta un nome in corrispondenza di un indice specificato della matrice di nomi alternativi.

Prima di usare questo metodo, è necessario chiamare ICertEncodeAltName::Reset in modo che l'oggetto sappia quanti elementi si trovano nella matrice.

Sintassi

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

Parametri

[in] NameIndex

Indice in base zero che specifica l'indice della voce del nome alternativo da impostare.

Se il parametro NameChoice è CERT_ALT_NAME_OTHER_NAME, OR (|) il valore di indice con EAN_NAMEOBJECTID (definito come 0x80000000) per impostare l'OID. In caso contrario, il valore binario è impostato.

[in] NameChoice

Specifica la scelta del nome. La scelta del nome indica il tipo del nome alternativo in modo che possa essere usato correttamente. Deve essere uno dei valori seguenti.

Valore	Significato
CERT_ALT_NAME_DIRECTORY_NAME	Il nome è un nome di directory.
CERT_ALT_NAME_DNS_NAME	Il nome è una stringa IA5 che specifica un nome DNS (Domain Name System) nel formato host.entity.domain.
CERT_ALT_NAME_IP_ADDRESS	Il nome è una stringa ottetto che rappresenta un indirizzo Internet Protocol.
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 identificatore di oggetto (OID) e da un BLOB binario.

[in] strName

Specifica il nome alternativo.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

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

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

Condividi tramite