WaitForAPIReady

9/8/2008

Essa função indica se o conjunto API especificado tiver sido registrado. Essa é uma versão non-polling da função IsAPIReady. O IsAPIReady função, que controla, é substituído.

Syntax

DWORD WaitForAPIReady(
DWORD dwAPISlotIndex,
DWORD dwTimeout
);

Parameters

• dwAPPISlotIndex
  Índice de slot de API para aguardar.

• dwTimeout
  Tempo limite para aguardar. Pode ser qualquer valor de milissegundos entre zero e infinite.

Return Value

• WAIT_FAILED
  Índice slot inválido ou uma falha non-Timeout.

• WAIT_OBJECT_0
  Conjunto API está registrado dentro de tempo limite especificado.

• WAIT_TIMEOUT
  Conjunto API não está registrado dentro de tempo limite especificado.

Remarks

O arquivo cabeçalho Pkfuncs.h contém definições para todos o API definir identificações.

Oferece suporte a Windows registrando até 128 conjuntos API, mas que conjuntos são registrados e quantos deles são usados é configurável pela OEM. Até mesmo uma configuração Maximum registra somente um subconjunto dos conjuntos de 128 completo. O seguinte exemplo de código mostra alguns dos conjuntos de API kernel-definido. Outros são definidos em projetos específicos.

#define SH_WIN32        0
#define SH_CURTHREAD    1
#define SH_CURPROC      2
#define SH_CURTOKEN     3
#define HT_EVENT        4 // Event handle type
#define HT_MUTEX        5 // Mutex handle type
#define HT_APISET       6 // kernel API set handle type
#define HT_FILE         7 // open file handle type
#define HT_FIND         8 // FindFirst handle type
#define HT_DBFILE       9 // open database handle type
#define HT_DBFIND       10 // database find handle type
#define HT_SOCKET       11 // WinSock open socket handle type
#define HT_CRITSEC      12 // Critical section
#define HT_SEMAPHORE    13 // Semaphore handle type
#define HT_FSMAP        14 // mapped files
#define HT_WNETENUM     15 // Net Resource Enumeration
#define HT_AFSVOLUME    16 // file system volume handle type
#define SH_GDI          80
#define SH_WMGR         81
#define SH_WNET         82 // WNet APIs for network redirector
#define SH_COMM         83 // Communications not COM
#define SH_FILESYS_APIS 84 // File system APIS
#define SH_SHELL        85
#define SH_DEVMGR_APIS  86 // File system device manager
#define SH_TAPI         87
#define SH_CPROG        88 // Handle to the specified API set
#define SH_SERVICES     90
#define SH_DDRAW        91
#define SH_D3DM         92

Requirements

Header	kfuncs.h
Library	coredll.dll
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

Kernel Functions
IsAPIReady

Concepts

Determining if an API is Ready
New Kernel APIs