Metodo ICertRequest2::GetCAProperty (certcli.h)

Articolo
02/23/2024

Il metodo GetCAProperty recupera un valore della proprietà per l'autorità di certificazione (CA). La funzionalità di questo metodo è identica a ICertAdmin2::GetCAProperty. Per informazioni su questo metodo, vedere ICertAdmin2::GetCAProperty.

Sintassi

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

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 e CANAME è 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.

[in] PropIndex

Se PropId viene indicizzato, l'indice in base zero da utilizzare durante il recupero del valore della proprietà. Se PropId non è indicizzato, questo valore viene ignorato.

[in] PropType

Specifica il tipo della proprietà , che corrisponde alla colonna Type nella tabella PropId . Il tipo può essere uno dei tipi seguenti.

Valore	Significato
PROPTYPE_LONG	Dati lunghi firmati
PROPTYPE_DATE	Data/ora (riservata per uso futuro)
PROPTYPE_BINARY	Dati binari
PROPTYPE_STRING	Dati stringa Unicode

[in] Flags

I flag seguenti possono essere utilizzati per specificare il formato del valore della proprietà restituita; questi flag hanno significato solo per i dati binari (ad esempio certificati, catene di certificati o elenchi di revoche di certificati) e vengono ignorati in caso contrario.

Valore	Significato
CV_OUT_BASE64	BASE64 senza BEGIN/END
CV_OUT_BASE64HEADER	BASE64 con BEGIN CERTIFICATE e END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 con BEGIN NEW CERTIFICATE REQUEST e END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 con BEGIN X509 CRL e END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Stringa esadecimale
CV_OUT_HEXADDR	Stringa esadecimale con indirizzo/offset
CV_OUT_HEXASCII	Stringa esadecimale con ASCII
CV_OUT_HEXASCIIADDR	Stringa esadecimale con ASCII e address/offset

[out, retval] pvarPropertyValue

Puntatore a un valore VARIANT che riceve il valore della proprietà richiesto.

Al termine dell'uso di VARIANT, liberarlo chiamando la funzione VariantClear .

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 dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un valore Variant che riceve il valore della proprietà richiesto.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
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

Vedi anche

CCertRequest

ICertRequest

ICertRequest2

Condividi tramite