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.
[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 |