Método ICertPolicy::GetDescription (certpol.h)

El método GetDescription devuelve una descripción legible del módulo de directiva y su función.

Sintaxis

HRESULT GetDescription(
  [out] BSTR *pstrDescription
);

Parámetros

[out] pstrDescription

Puntero a un BSTR que describe el módulo de directivas.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

Devuelve una cadena que describe el módulo de directiva y su función.

Comentarios

Al escribir módulos de directivas personalizados, implemente este método.

Ejemplos

#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 );
}

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certpol.h (incluya Certsrv.h)
Library	Certidl.lib

Consulte también

ICertPolicy

ICertPolicy2