Método ICertRequest2::GetCAProperty (certcli.h)

  • Artigo

O método GetCAProperty recupera um valor de propriedade para a AC (autoridade de certificação ). A funcionalidade desse método é idêntica a ICertAdmin2::GetCAProperty. Para obter informações sobre esse método, consulte ICertAdmin2::GetCAProperty.

Sintaxe

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

Parâmetros

[in] strConfig

Representa uma cadeia de caracteres de configuração válida para a AC no formato COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor dos Serviços de Certificados e CANAME é o nome comum da AC, conforme inserido durante a instalação dos Serviços de Certificado. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.

[in] PropId

Especifica o identificador de propriedade. Para obter informações sobre esse parâmetro, consulte a tabela em ICertAdmin2::GetCAProperty.

[in] PropIndex

Se PropId for indexado, o índice baseado em zero a ser usado ao recuperar o valor da propriedade. Se PropId não for indexado, esse valor será ignorado.

[in] PropType

Especifica o tipo da propriedade , que corresponde à coluna Type na tabela PropId . O tipo pode ser um dos tipos a seguir.

Valor Significado
PROPTYPE_LONG
 Dados longos assinados
PROPTYPE_DATE
 Data/hora (reservada para uso futuro)
PROPTYPE_BINARY
 Dados binários
PROPTYPE_STRING
 Dados de cadeia de caracteres Unicode

[in] Flags

Os sinalizadores a seguir podem ser usados para especificar o formato do valor da propriedade retornado; esses sinalizadores têm significado apenas para dados binários (como certificados, cadeias de certificados ou listas de revogação de certificados) e são ignorados de outra forma.

Valor Significado
CV_OUT_BASE64
 BASE64 sem BEGIN/END
CV_OUT_BASE64HEADER
 BASE64 com BEGIN CERTIFICATE e END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER
 BASE64 COM BEGIN NEW CERTIFICATE REQUEST E END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER
 BASE64 com BEGIN X509 CRL e END X509 CRL
CV_OUT_BINARY
 Binário
CV_OUT_HEX
 Cadeia de caracteres hexadecimal
CV_OUT_HEXADDR
 Cadeia de caracteres hexadecimal com endereço/deslocamento
CV_OUT_HEXASCII
 Cadeia de caracteres hexadecimal com ASCII
CV_OUT_HEXASCIIADDR
 Cadeia de caracteres hexadecimal com ASCII e endereço/deslocamento

[out, retval] pvarPropertyValue

Um ponteiro para um VARIANT que recebe o valor da propriedade solicitada.

Quando terminar de usar o VARIANT, libere-o chamando a função VariantClear .

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é um Variant que recebe o valor da propriedade solicitada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certcli.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certcli.dll

Confira também

CCertRequest

ICertRequest

ICertRequest2