Função NdrPointerUnmarshall (rpcndr.h)

A função NdrPointerUnmarshall unmarshalls um ponteiro de nível superior para qualquer coisa. Ponteiros inseridos em estruturas, matrizes ou uniões chamam NdrPointerUnmarshall diretamente.

Sintaxe

unsigned char * NdrPointerUnmarshall(
  [in, out] PMIDL_STUB_MESSAGE pStubMsg,
  [in]      unsigned char      **ppMemory,
  [in]      PFORMAT_STRING     pFormat,
  [in]      unsigned char      fMustAlloc
);

Parâmetros

[in, out] pStubMsg

Ponteiro para uma estrutura de MIDL_STUB_MESSAGE que mantém a status atual do stub RPC. A estrutura é somente para uso interno; não modifique.

[in] ppMemory

Ponteiro para a memória em que o ponteiro será não solicitado. Consulte Proteção de Buffer MCCP para obter informações sobre proteções de estouro de buffer no RPC: http://msdn.microsoft.com/en-us/library/ff621497(VS.85).aspx

[in] pFormat

Ponteiro para a descrição da cadeia de caracteres de formato.

[in] fMustAlloc

Não utilizado.

Retornar valor

Retorna NULL após o êxito. Se ocorrer um erro, a função lançará um dos seguintes códigos de exceção.

Erro	Descrição
RPC_BAD_STUB_DATA ou RPC_X_INVALID_BOUND	O buffer de rede está incorreto.
RPC_S_OUT_OF_MEMORY	O sistema está sem memória.
STATUS_ACCESS_VIOLATION	Ocorreu uma violação de acesso.
RPC_S_INTERNAL_ERROR	Ocorreu um erro no RPC.

Comentários

Essa função é usada para cadeias de caracteres de formato FC_RP, FC_UP, FC_FP FC_OP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	rpcndr.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll