HttpSetRequestProperty-Funktion (http.h)

Die HttpSetRequestProperty-Funktion legt eine neue Eigenschaft fest oder ändert eine vorhandene Eigenschaft für die angegebene Anforderung.

Syntax

HTTPAPI_LINKAGE ULONG HttpSetRequestProperty(
  [in] HANDLE                RequestQueueHandle,
  [in] HTTP_OPAQUE_ID        Id,
  [in] HTTP_REQUEST_PROPERTY PropertyId,
  [in] PVOID                 Input,
  [in] ULONG                 InputPropertySize,
  [in] LPOVERLAPPED          Overlapped
);

Parameter

[in] RequestQueueHandle

Das Handle für die Anforderungswarteschlange, in der die Anforderung empfangen wurde. Eine Anforderungswarteschlange wird erstellt, und ihr Handle wird durch einen Aufruf der HttpCreateRequestQueue-Funktion zurückgegeben.

[in] Id

Die undurchsichtige ID der Anforderung. Diese ID befindet sich im RequestId-Member der HTTP_REQUEST Struktur, die von HttpReceiveHttpRequest zurückgegeben wird.

[in] PropertyId

Ein Member der HTTP_REQUEST_PROPERTY-Enumeration , die den festgelegten Eigenschaftstyp beschreibt. Dies muss einer der folgenden Sein:

| Eigenschaft | Bedeutung | | HttpRequestPropertyStreamError | Legt einen Streamfehler für die Anforderung fest. |

[in] Input

Ein Zeiger auf den Puffer, der die Eigenschafteninformationen enthält.

Er muss basierend auf der festgelegten Eigenschaft auf einen der folgenden Eigenschafteninformationstypen verweisen.

| Eigenschaft | Konfigurationstyp | | HttpRequestPropertyStreamError | HTTP_REQUEST_PROPERTY_STREAM_ERROR Struktur |

[in] InputPropertySize

Die Länge des Puffers in Bytes, auf den der Eingabeparameter verweist.

[in] Overlapped

Legen Sie bei asynchronen Aufrufen pOverlapped so fest, dass er auf eine OVERLAPPED-Struktur verweist. Legen Sie für synchrone Aufrufe auf NULL fest.

Ein synchroner Aufruf blockiert, bis der Vorgang abgeschlossen ist, während ein asynchroner Aufruf sofort ERROR_IO_PENDING zurückgibt, und die aufrufende Anwendung verwendet dann GetOverlappedResult - oder E/A-Vervollständigungsports, um zu bestimmen, wann der Vorgang abgeschlossen ist. Weitere Informationen zur Verwendung von OVERLAPPED-Strukturen für die Synchronisierung finden Sie unter Synchronisierung und überlappende Eingabe und Ausgabe.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen Systemfehlercode zurück.

Requirements (Anforderungen)

Weitere Informationen

HttpSetRequestQueueProperty