Método IX509AttributeOSVersion::InitializeEncode (certenroll.h)

O método InitializeEncode inicializa o atributo das informações de versão do sistema operacional.

Sintaxe

HRESULT InitializeEncode(
  [in, optional] BSTR strOSVersion
);

Parâmetros

[in, optional] strOSVersion

Uma variável BSTR que contém as informações de versão. O formato da cadeia de caracteres é major.minor.build.platform. Esse parâmetro é opcional. Se você não especificar uma cadeia de caracteres, esse método chamará a função GetVersionEx .

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ê 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 ( Abstract Syntax Notation One ) 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

Confira também

IX509AttributeOSVersion