Método IX509AttributeOSVersion::InitializeDecode (certenroll.h)
O método InitializeDecode inicializa o objeto de uma matriz de bytes codificada em Distinguished Encoding Rules (DER) que contém as informações de versão do sistema operacional. A matriz de bytes é representada por uma cadeia de caracteres codificada em Unicode.
Sintaxe
HRESULT InitializeDecode(
[in] EncodingType Encoding,
[in] BSTR strEncodedData
);
Parâmetros
[in] Encoding
Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à cadeia de caracteres de entrada.
[in] strEncodedData
Uma variável BSTR que contém o atributo codificado em DER.
Retornar valor
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
O OID ( identificador de objeto ) para esse atributo é XCN_OID_OS_VERSION (1.3.6.1.4.1.311.13.2.3). Para obter mais informações, consulte CERTENROLL_OBJECTID.
Você poderá usar esse método se tiver um objeto ASN.1 ( Abstract Syntax Notation One ) codificado em DER que contenha o valor do atributo. Você deve fornecer o objeto codificado em DER em uma cadeia de caracteres codificada em Unicode. Para obter mais informações, consulte a interface IBinaryConverter .
Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509AttributeOSVersion . Os dois métodos se complementam. O método InitializeEncode permite que você construa uma estrutura ASN.1 codificada com base em dados brutos e o método InitializeDecode permite inicializar dados brutos de uma estrutura ASN.1 codificada. Você pode chamar a propriedade OSVersion para recuperar os dados brutos.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |