Metodo ICertPolicy::GetDescription (certpol.h)

Articolo
02/23/2024

Il metodo GetDescription restituisce una descrizione leggibile del modulo dei criteri e della relativa funzione.

Sintassi

HRESULT GetDescription(
  [out] BSTR *pstrDescription
);

Parametri

[out] pstrDescription

Puntatore a un BSTR che descrive il modulo dei criteri.

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

Restituisce una stringa che descrive il modulo dei criteri e la relativa funzione.

Commenti

Quando si scrivono moduli di criteri personalizzati, implementare questo metodo.

Esempio

#include <windows.h>
#include <Certpol.h>

STDMETHODIMP CCertPolicy::GetDescription(
    /* [out, retval] */ BSTR __RPC_FAR *pstrDescription)
{
    if (NULL == pstrDescription)
    {
        // Bad pointer address
        return ( E_POINTER );
    }
    if (NULL != *pstrDescription)
    {
        SysFreeString(*pstrDescription);
        *pstrDescription=NULL;
    }
    // wszMyModuleDesc defined elsewhere, for example:
    // #define wszMyModuleDesc L"My Policy Module"
    *pstrDescription = SysAllocString(wszMyModuleDesc);
    if (NULL == *pstrDescription)
    {
        // Not enough memory
        return ( E_OUTOFMEMORY );
    }
    // Success
    return( S_OK );
}

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certpol.h (includere Certsrv.h)
Libreria	Certidl.lib

Vedi anche

ICertPolicy

ICertPolicy2

Condividi tramite