¿Cuándo devuelve E_POINTER y cuándo E_INVALIDARG?

Question

Los métodos de las interfaces COM pueden devolver varios valores de HRESULT para señalar los valores de los argumentos inválidos pasados. ¿Cuándo devuelvo E_POINTER y cuándo E_INVALIDARG?

Como entiendo si un método recibe un índice en una colección encapsulada y está fuera de límites que es E_INVALIDARG. Si un método recibe un puntero Interface** donde está destinado a almacenar un puntero a un objeto recién creado que es E_POINTER.

HRESULT CImpl::GetItem(long index; Interface** result) 
{ 
    if(result == 0) { 
     return E_POINTER; 
    } 
    if(index < 0 || index >= internalArray.size()) { 
     return E_INVALIDARG; 
    } 
    *result = CreateWrapperObject(internalArray[index]); 
    return S_OK; 
} 

Pero lo que si recibe un buffer WCHAR* con un nombre de archivo como un "in" parámetro y esto WCHAR* es nulo? ¿Es esto E_POINTER o E_INVALIDARG?

O un método recibe un puntero a alguna estructura y se espera que llene la estructura a través de ese puntero y este puntero es nulo, ¿es este E_POINTER o E_INVALIDARG?

HRESULT CImpl::SaveToFile(WCHAR* fileName) 
{ 
    if(fileName == 0) { 
     return // what to return here? 
    } 
    //... do actual work here 
} 

HRESULT CImpl::GetAttributes(Attributes* to) 
{ 
    if(to == 0) { 
     return // what to return here? 
    } 
    attributes->IsCool = getIsCool(); 
    attributes->Color = RGB(0, 255, 0); 
    return S_OK; 
} 

¿Cuáles son las reglas de cuándo debe regresar E_POINTER y cuando E_INVALIDARG Tras un análisis de los parámetros de tipo puntero?

Answer 1

que regrese E_POINTER cuando la referencia al puntero de un parámetro cabo es nulo, esto consideran que es un código de error que indica un error en el programa o en la capa de interoperabilidad.

Devuelve E_INVALIDARG cuando hay un nivel de aplicación activado con el parámetro por ejemplo fuera de rango o parámetro que colisionan entre sí.

en su caso, en SaveToFile(...) debe devolver E_INVLIADARG ya que no es válida para pasar el nombre de archivo vacío, y en GetAttributes(...) debe volver E_POINTER (si es un parámetro fuera) porque no se puede llenar el valor.

Y sí, todos nosotros L-O-V-E com :)