Compartir a través de

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

  • Artículo

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