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

Artigo
02/26/2024

O método GetCAPropertyFlags recupera os sinalizadores de propriedade para uma propriedade de AC (autoridade de certificação ).

Sintaxe

HRESULT GetCAPropertyFlags(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] LONG       *pPropFlags
);

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 de Serviços de Certificados e CAName é o nome comum da AC, conforme inserido durante a instalação dos Serviços de Certificados. 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.

[out, retval] pPropFlags

Um ponteiro para um valor LONG que representa os sinalizadores de propriedade.

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 Long que representa os sinalizadores de propriedade.

Comentários

A funcionalidade do método GetCAPropertyFlags é semelhante à do método ICertAdmin2::GetCAPropertyFlags .

No método ICertAdmin2, a AC impõe que o chamador tenha acesso de leitura da AC, que geralmente só é concedida a oficiais de AC e administradores de AC.

Por outro lado, nas implementações ICertRequest2 e ICertRequest3 do método , a AC não requer direitos de acesso por padrão. Somente as ACLs ( listas de controle de acesso ) do DCOM (Modelo de Objeto de Componente Distribuído) são impostas; para uma AC ingressada no domínio, as ACLs do DCOM permitem que Todos acessem as ACs. Todos não incluem Anônimo. A interface de solicitação da AC pode ser bloqueada usando a configuração do Registro para impor que o chamador tenha acesso de registro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
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