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