Edit

DceErrorInqTextA function (rpcdce.h)

  • Article

The DceErrorInqText function returns the message text for a status code.

Syntax

RPC_STATUS DceErrorInqTextA(
  RPC_STATUS RpcStatus,
  RPC_CSTR   ErrorText
);

Parameters

RpcStatus

Status code to convert to a text string.

ErrorText

Returns the text corresponding to the error code.

Value Meaning
RPC_S_OK
 The call succeeded.
RPC_S_INVALID_ARG
 Unknown error code.

Return value

This function returns RPC_S_OK if it is successful, or an error code if not.

Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

The DceErrorInqText routine fills the string pointed to by the ErrorText parameter with a null-terminated character string message for a particular status code.

Note

The rpcdce.h header defines DceErrorInqText as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll