ReadMsgQueueEx

9/8/2008

Esta função lê uma única mensagem de uma fila de mensagens e opcionalmente retorna o contexto de segurança, ou token, a partir de gravador. Isso permite que servidores fila de mensagens para executar a segurança no nível do cliente de fila de mensagens, para que o servidor fila de mensagens falhará se ele tentar uma operação privilegiada.

Syntax

BOOL ReadMsgQueueEx(
  HANDLE hMsgQ, 
  LPVOID lpBuffer,
  DWORD cbBufferSize,
  LPDWORD lpNumberOfBytesRead,
  DWORD dwTimeout,
  DWORD *pdwFlags,
  PHANDLE phTok
);

Parameters

• hMsgQ
  [no] Identificador para o fila de mensagens.

• lpBuffer
  [in, Out] Ponteiro para a reserva que receberá a mensagem.

• cbBufferSize
  [no] Tamanho da reserva que recebe a mensagem.

• lpNumberOfBytesRead
  [in, Out] Número de bytes ler.

• dwTimeout
  [no] Tempo limite para o operação de leitura.

• pdwFlags
  [in, Out] Recebe o sinalizador enviadas pelo gravador da fila de mensagens.

• phTok
  [in, Out] Recebe o token identificador do gravador da fila de mensagens. Definir como NULL se você não precisar o token de segurança para o gravador. O chamador é responsável por chamado CloseHandle no token retornado.

Return Value

TRUE indica sucesso. FALSE indica falha. Para obter informações de erro estendidas, chamar a função GetLastError.

Remarks

Se *phTok Retorna um NULL valor, o token retornado é NULL, de modo que o remetente é um segmento kernel e não pode ser representado.

Quando o fila de mensagens é ler, o leitor pode ser aberto um identificador para token de segurança do gravador. O leitor pode usar o token para representar contexto de segurança do gravador.

Requirements

See Also

Reference

Message Queue Point-to-Point Functions
CloseMsgQueue
CreateMsgQueue
GetMsgQueueInfo
MSGQUEUEINFO
MSGQUEUEOPTIONS
OpenMsgQueue
ReadMsgQueue
WriteMsgQueue

Other Resources

New Kernel APIs
Message Queue Point-to-Point