3.1.4.1.17 ICertAdminD::GetServerState (Opnum 19)

The GetServerState method is used to validate that the caller has permission to read the CA database.

 HRESULT GetServerState(
   [in, string, unique] wchar_t const* pwszAuthority,
   [out] DWORD* pdwState
 );

pwszAuthority:  See the pwszAuthority definition in section 3.1.4.1.1.

pdwState: A pointer to an unsigned integer value that specifies whether the caller has permission to read from the CA database.

The CA MUST return 1 for pdwState if the caller has permission to read from the CA database. Otherwise, the CA MUST return 0.