Compartilhar via


Método IAlternativeName::InitializeFromString (certenroll.h)

O método InitializeFromString inicializa o objeto de uma cadeia de caracteres que contém um endereço de email, um nome DNS (Sistema de Nomes de Domínio), uma URL, um OID ( identificador de objeto registrado) ou um UPN ( nome principal do usuário ).

Sintaxe

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

Parâmetros

[in] Type

Um valor de enumeração AlternativeNameType que identifica o tipo de nome representado pela cadeia de caracteres de entrada contida no parâmetro strValue . Esse deve ser um dos valores a seguir.

Valor Significado
XCN_CERT_ALT_NAME_RFC822_NAME
O nome é um endereço de email.
XCN_CERT_ALT_NAME_DNS_NAME
O nome é um nome DNS.
XCN_CERT_ALT_NAME_URL
O nome é uma URL.
XCN_CERT_ALT_NAME_REGISTERED_ID
O nome é um OID registrado.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME
O nome é um UPN.

[in] strValue

Uma variável BSTR que contém o nome.

Valor retornado

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Se você usar esse método para especificar um UPN, o UPN será associado ao OID XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) e será codificado Distinguished Encoding Rules (DER). Você pode chamar a propriedade RawData para recuperar a matriz de bytes codificada. Você pode recuperar o OID chamando a propriedade ObjectId .

Se você usar esse método para especificar qualquer um dos seguintes tipos de nome, o método retornará E_INVALIDARG.

Valor Descrição
XCN_CERT_ALT_NAME_UNKNOWN O tipo de nome não é identificado.
XCN_CERT_ALT_NAME_OTHER_NAME O nome consiste em um OID e uma matriz de bytes.
XCN_CERT_ALT_NAME_DIRECTORY_NAME O nome é um nome de diretório X.500 .
XCN_CERT_ALT_NAME_IP_ADDRESS O nome é um endereço IP.
XCN_CERT_ALT_NAME_GUID O nome é um GUID.
 

Você pode usar o método InitializeFromOtherName para especificar um OID e uma cadeia de caracteres de nome correspondente, e você pode usar o método InitializeFromRawData para especificar um guid, endereço IP ou nome do diretório X.500.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h
DLL CertEnroll.dll

Confira também

IAlternativeName

IAlternativeNames

IX509ExtensionAlternativeNames