RpcAsyncInitializeHandle-Funktion (rpcasync.h)

Artikel
08/25/2023

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
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_ARG	Die Größe ist entweder zu klein oder zu groß.
RPC_S_INVALID_ASYNC_HANDLE	pAsync verweist auf ungültigen Arbeitsspeicher.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

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.

Hinweis In Windows 2000 muss nach Abschluss eines asynchronen Aufrufs die RPC_ASYNC_STATE-Struktur erneut initialisiert werden, bevor sie für einen anderen asynchronen Aufruf verwendet wird. In Windows XP und höher ist die RPC_ASYNC_STATE-Struktur nach einem abgeschlossenen asynchronen Aufruf zur sofortigen Wiederverwendung bereit.

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