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)
| Zielplattform | Windows |
| Kopfzeile | http.h |
| Bibliothek | Httpapi.lib |
| DLL | Httpapi.dll |