ServiceIoControl

9/8/2008

Essa função envia uma codificar controle diretamente para um driver de dispositivo especificado causando a correspondente dispositivo para executar a operação especificada. Essa função é substituído. Para obter um identificador para um serviço, chamar CreateFile. Para controle de serviço, chamar DeviceIoControl com os mesmos parâmetros você definiria para ServiceIoControl.

Syntax

BOOL ServiceIoControl(
  HANDLE hService,
  DWORD dwIoControlCode,
  LPVOID lpInBuf,
  DWORD nInBufSize,
  LPVOID lpOutBuf,
  DWORD nOutBufSize,
  LPDWORD lpBytesReturned,
  LPOVERLAPPED lpOverlapped
);

Parameters

• hService
  [no] Identificador para o serviço que deve executar a operação especificada. O GetServiceHandle função deve ser chamado para obter um identificador serviço desconhecido.

• dwIoControlCode
  [no] Especifica a codificar controle para a operação. Esse valor indica a operação específica para ser realizado e o tipo de dispositivo no qual a operação está para ser realizado. Há valores são definidos para esse parâmetro; No entanto, o gravador de um personalizado driver de dispositivo podem definir IOCTL_XXX controle códigos pela macro CTL_CODE. Esses controle códigos, em seguida, podem ser anunciados e um aplicativo podem usá-los juntamente com DeviceIoControl Para executar funções driver-specific.

• lpInBuf
  [no] Ponteiro para uma reserva que contém os dados exigido para executar a operação. Este parâmetro pode ser definido como NULL se o dwIoControlCode parâmetro especifica uma operação que não requer entrada dados.

• nInBufSize
  [no] Tamanho, em bytes, da reserva apontado pelo lpInBuffer.

• lpOutBuf
  [out] Ponteiro para uma reserva que recebe dados saída da operação. Este parâmetro pode ser definido como NULL se o dwIoControlCode parâmetro especifica uma operação que não gerar saída dados.

• nOutBufSize
  [no] Tamanho, em bytes, da reserva apontado pelo lpOutBuffer.

• lpBytesReturned
  [out] Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados armazenados na reserva apontado pelo lpOutBuffer. Mesmo quando uma operação não produz dados nenhuma saída e lpOutBuffer Pode ser definida para NULL, o ServiceIoControl função faz uso da variável apontado pelo lpBytesReturned.

• lpOverlapped
  [no] Este parâmetro é ignorado e definido como NULL.

Return Value

Um diferente de zero valor indica sucesso. Um valor de zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

ServiceIoControl é substituído. Para obter um identificador para um serviço, chamar CreateFile. Para controle de serviço, chamar DeviceIoControl com os mesmos parâmetros você definiria para ServiceIoControl.

Requirements

Header	service.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

ActivateService
RegisterService
GetServiceHandle
EnumServices

Other Resources

CreateFile
DeviceIoControl
Services.exe