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

Artigo
02/26/2024

O método GetCAPropertyDisplayName recupera o nome de exibição da propriedade para uma propriedade de AC (autoridade de certificação ).

Sintaxe

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

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

[out, retval] pstrDisplayName

Um ponteiro para o BSTR que representa o nome de exibição da propriedade. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .

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 String que contém o nome de exibição da propriedade.

Comentários

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

No método ICertAdmin2, a AC impõe que o chamador tenha acesso de leitura da AC, que geralmente só é concedido 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