Metodo ICertPolicy::GetDescription (certpol.h)

  • Articolo

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