ITableData::HrQueryRow
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera uma linha de tabela.
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
Parâmetros
lpSPropValue
[in] Um ponteiro para uma estrutura de valor de propriedade que descreve a coluna de índice para a linha a ser recuperada. O membro ulPropTag da estrutura de valor da propriedade deve conter a mesma marca de propriedade que o parâmetro ulPropTagIndexColumn da chamada para a função CreateTable , que acessa a implementação ITableData .
lppSRow
[out] Um ponteiro para um ponteiro para a linha recuperada.
lpuliRow
[in, out] Na entrada, um ponteiro válido ou NULL, que indica que nenhuma informação precisa ser retornada. Na saída, um ponteiro válido que aponta para o número da linha da linha, um número sequencial que identifica a posição da linha na tabela.
Valor de retorno
S_OK
A linha foi recuperada com êxito.
MAPI_E_INVALID_PARAMETER
A estrutura SPropValue à qual lpSPropValue aponta não contém a propriedade da coluna de índice.
Comentários
O método ITableData::HrQueryRow recupera todas as propriedades da linha que tem uma coluna de índice que corresponde ao valor da coluna de índice incluída na estrutura da propriedade apontada por lpSPropValue. HrQueryRow também retorna o número da linha, se o chamador solicitar, que identifica a posição da linha na tabela.
Como HrQueryRow não modifica a estrutura SPropValue apontada por lpSPropValue, os chamadores devem liberar a estrutura quando HrQueryRow retornar. Os chamadores também devem liberar a estrutura SRow que contém a linha recuperada.