Compartilhar via


Função WsCreateError (webservices.h)

Cria um objeto de erro que pode ser passado para funções para registrar informações de erro avançadas.

Sintaxe

HRESULT WsCreateError(
       const WS_ERROR_PROPERTY *properties,
  [in] ULONG                   propertyCount,
       WS_ERROR                **error
);

Parâmetros

properties

Uma matriz de estruturas de WS_ERROR_PROPERTY que contém propriedades de erro opcionais.

[in] propertyCount

O número de propriedades na matriz de propriedades .

error

Em caso de êxito, um ponteiro que recebe o endereço da estrutura WS_ERROR que representa o objeto de erro criado.

Retornar valor

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retornará um código de erro HRESULT.

Código de retorno Descrição
E_INVALIDARG
Um ou mais argumentos são inválidos.
E_OUTOFMEMORY
Memória insuficiente para concluir a operação.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Quando você não precisar muito do objeto de erro, libere-o chamando a função WsFreeError .

Por padrão, o idioma de qualquer informação dependente de idioma no objeto de erro é o idioma da interface do usuário padrão do usuário atual. No entanto, você pode alterar o idioma definindo a propriedade WS_ERROR_PROPERTY_LANGID. Consulte a enumeração WS_ERROR_PROPERTY_ID .

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll