RpcAsyncInitializeHandle-Funktion (rpcasync.h)
Der Client ruft die RpcAsyncInitializeHandle-Funktion auf, um die RPC_ASYNC_STATE Struktur zu initialisieren, die für einen asynchronen Aufruf verwendet werden soll.
Syntax
RPC_STATUS RpcAsyncInitializeHandle(
PRPC_ASYNC_STATE pAsync,
unsigned int Size
);
Parameter
pAsync
Zeiger auf die RPC_ASYNC_STATE-Struktur , die asynchrone Aufrufinformationen enthält.
Size
Größe der RPC_ASYNC_STATE-Struktur .
Rückgabewert
Wert | Bedeutung |
---|---|
|
Der Aufruf war erfolgreich. |
|
Die Größe ist entweder zu klein oder zu groß. |
|
pAsync verweist auf ungültigen Arbeitsspeicher. |
Hinweise
Der Client erstellt eine neue RPC_ASYNC_STATE-Struktur und einen Zeiger auf diese Struktur und ruft RpcAsyncInitializeHandle mit dem Zeiger als Eingabeparameter auf. Die RpcAsyncInitializeHandle-Funktion initialisiert die Felder, die zum Beibehalten des Zustands eines asynchronen Remoteaufrufs verwendet werden. Wenn der Aufruf von RpcAsyncInitializeHandle erfolgreich zurückgegeben wird, kann der Client den Benachrichtigungstyp und alle Felder im Zusammenhang mit diesem Benachrichtigungstyp in der RPC_ASYNC_STATE-Struktur festlegen. Die Clientanwendung verwendet einen Zeiger auf diese Struktur, um einen asynchronen Aufruf zu tätigen.
Der Client sollte nicht versuchen, die Member Size, Signature, Lock und StubInfo der RPC_ASYNC_STATE-Struktur zu ändern. Dadurch wird das Handle ungültig.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | rpcasync.h (include Rpc.h) |
Bibliothek | Rpcrt4.lib |
DLL | Rpcrt4.dll |