Metodo ICertRequest2::GetCAPropertyFlags (certcli.h)

Articolo
02/23/2024

Il metodo GetCAPropertyFlags recupera i flag di proprietà per una proprietà ca (Certification Authority ).

Sintassi

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

Parametri

[in] strConfig

Rappresenta una stringa di configurazione valida per la CA nel formato ComputerName\ CAName, dove ComputerName è il nome di rete del server Servizi certificati eCAName è il nome comune della CA, come immesso durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

[in] PropId

Specifica l'identificatore della proprietà. Per informazioni su questo parametro, vedere la tabella in ICertAdmin2::GetCAProperty.

[out, retval] pPropFlags

Puntatore a un valore LONG che rappresenta i flag delle proprietà.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un valore Long che rappresenta i flag di proprietà.

Commenti

La funzionalità del metodo GetCAPropertyFlags è simile a quella del metodo ICertAdmin2::GetCAPropertyFlags .

Nel metodo ICertAdmin2 l'autorità di certificazione applica che il chiamante abbia accesso in lettura CA, che in genere viene concesso solo agli amministratori della CA e agli amministratori della CA.

Al contrario, nelle implementazioni ICertRequest2 e ICertRequest3 del metodo, la CA non richiede alcun diritto di accesso per impostazione predefinita. Vengono applicati solo gli elenchi di controllo di controllo di accesso DCOM (Distributed Component Object Model). per una CA aggiunta a un dominio, gli ACL DCOM consentono a Tutti l'accesso alle autorità di certificazione. Tutti non includono Anonimo. L'interfaccia della richiesta della CA può essere bloccata usando la configurazione del Registro di sistema per imporre che il chiamante abbia accesso registrato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certcli.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certcli.dll