Data.Cloud.AzureAPI.TAzureQueueService.GetMessagesXML

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetMessagesXML(const QueueName: string;
NumOfMessages: Integer = 0;
VisibilityTimeout: Integer = 0;
ResponseInfo: TCloudResponseInfo = nil): string;

C++

System::UnicodeString __fastcall GetMessagesXML(const System::UnicodeString QueueName, int NumOfMessages = 0x0, int VisibilityTimeout = 0x0, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Data.Cloud.AzureAPI.pas
Data.Cloud.AzureAPI.hpp
Data.Cloud.AzureAPI TAzureQueueService


Beschreibung

Gibt die XML-Repräsentation der Nachrichten zurück.

Mit GetMessagesXML wird die XML-Repräsentation der Nachrichten aus der angegebenen Queue ermittelt.

Die folgende Tabelle gibt die Bedeutung der Parameter an:

Parameter Beschreibung

QueueName

Der Name der Queue, für die die Nachrichten ermittelt werden sollen

NumOfMessages

Die maximale Anzahl der NAchrichteb, die zurückgegeben werden sollen

VisibilityTimeout

Zeitspanne, die die Nachrichten reserviert werden sollten

ResponseInfo

Die optionale Klasse zum Speichern der Antwortinformationen


Ist NumOfMessages nicht gesetzt, wird der Vorgabewert des Servers (1) verwendet. Der zulässige Maximalwert ist 32.

Ist VisibilityTimeout nicht gesetzt, wird der Vorgabewert des Servers (30 Sekunden) verwendet. Der zulässige Maximalwert ist 2 Stunden.

Für die von diesem Aufruf zurückgegebenen Nachrichten wird der Data.Cloud.CloudAPI.TCloudQueueMessage.PopReceipt-Wert angegeben. Dieser Wert gilt während der in VisibilityTimeout angegebenen Zeitspanne als eindeutiges Token der Nachricht, das zum Löschen der Nachricht verwendet werden kann.

Siehe auch