CComCoClass::Error

Esta función estática coloque la interfaz de IErrorInfo para proporcionar información de error al cliente.

static HRESULT WINAPI Error(
   LPCOLESTR lpszDesc,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   LPCOLESTR lpszDesc,
   DWORD dwHelpID,
   LPCOLESTR lpszHelpFile,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   LPCSTR lpszDesc,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   LPCSTR lpszDesc,
   DWORD dwHelpID,
   LPCSTR lpszHelpFile,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0 
);
static HRESULT WINAPI Error(
   UINT nID,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0,
   HINSTANCE hInst = _AtlBaseModule.GetResourceInstance ()
);
static HRESULT Error(
   UINT nID,
   DWORD dwHelpID,
   LPCOLESTR lpszHelpFile,
   const IID& iid = GUID_NULL,
   HRESULT hRes = 0,
   HINSTANCE hInst = _AtlBaseModule.GetResourceInstance() 
);

Parámetros

  • lpszDesc
    [in] la cadena que describe el error.La versión Unicode de Error especifica que lpszDesc es de LPCOLESTRescrito; la versión ANSI especifica un tipo de LPCSTR.

  • iid
    [in] IID de la interfaz que define el error o GUID_NULL (valor predeterminado) si el error está definido por el sistema operativo.

  • hRes
    [in] HRESULT que desee volver al llamador.El valor predeterminado es 0.Para obtener más detalles sobre hRes, vea las notas.

  • nID
    [in] El identificador de recursos donde se almacena la cadena de descripción del error.Este valor debe mentir entre 0x0200 y 0xFFFF, incluidos.En las compilaciones de depuración, DECLARAR se producirá si no lo hace nID índice una cadena válida.En las versiones de lanzamiento, la cadena de descripción del error será “error desconocido establecido”.

  • dwHelpID
    [in] El identificador de contexto de ayuda para el error.

  • lpszHelpFile
    [in] La ruta de acceso y el nombre del archivo de ayuda que describe el error.

  • hInst
    [in] El identificador del recurso.De forma predeterminada, este parámetro es _AtlModule::GetResourceInstance, donde es la instancia _AtlModule global de CAtlModule.

Valor devuelto

un valor estándar de HRESULT .Para obtener detalles, vea las notas.

Comentarios

Para llamar a Error, el objeto debe implementar la interfaz de ISupportErrorInfo Interface .

Si el parámetro de hRes es distinto de cero, después Error devuelve el valor de hRes.Si hRes es cero, las primeras cuatro versiones de retorno DISP_E_EXCEPTIONde Error .Las dos versiones últimas devuelve el resultado de MAKE_HRESULT (1, FACILITY_ITF, macronID ).

Requisitos

encabezado: atlcom.h

Vea también

Referencia

Clase de CComCoClass

Clase de ISupportErrorInfoImpl

MAKE_HRESULT

  • Last updated on