Função RpcErrorSaveErrorInfo (rpcasync.h)
A função RpcErrorSaveErrorInfo retorna todas as informações de erro para um identificador de enumeração como um BLOB.
Sintaxe
RPC_STATUS RpcErrorSaveErrorInfo(
[in] RPC_ERROR_ENUM_HANDLE *EnumHandle,
[out] PVOID *ErrorBlob,
[out] size_t *BlobSize
);
Parâmetros
[in] EnumHandle
Ponteiro para o identificador de enumeração.
[out] ErrorBlob
Ponteiro para o BLOB que contém as informações de erro.
[out] BlobSize
Tamanho de ErrorBlob, em bytes.
Retornar valor
A conclusão bem-sucedida retorna RPC_S_OK. A chamada de função RpcErrorSaveErrorInfo poderá falhar se não houver memória suficiente disponível.
Comentários
O BLOB é alocado no heap do sistema e o chamador é o proprietário do buffer. O bloco alocado no heap do sistema pode ser maior que BlobSize, mas apenas BlobSize é usado. A função RpcErrorSaveErrorInfo salva toda a cadeia de registros de informações de erro estendidos associados ao identificador de enumeração, independentemente da posição do cursor, e não altera a posição do cursor para a enumeração.
O BLOB pode ser salvo e recuperado posteriormente usando a função RpcErrorLoadErrorInfo .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | rpcasync.h (inclua Rpc.h) |
| Biblioteca | Rpcrt4.lib |
| DLL | Rpcrt4.dll |