Metodo IScheduledWorkItem::GetTriggerString (mstask.h)

Articolo
02/29/2024

[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]

Recupera una stringa che descrive il trigger dell'elemento di lavoro .

Sintassi

HRESULT GetTriggerString(
  [in]  WORD   iTrigger,
  [out] LPWSTR *ppwszTrigger
);

Parametri

[in] iTrigger

Indice del trigger da recuperare. Il primo trigger viene sempre fatto riferimento a 0. Per altre informazioni, vedere la sezione Osservazioni.

[out] ppwszTrigger

Puntatore a una stringa con terminazione Null contenente la descrizione del trigger recuperata. Si noti che questa stringa deve essere rilasciata da una chiamata a CoTaskMemFree dopo che la stringa non è più necessaria.

Valore restituito

Il metodo GetTriggerString restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	L'operazione è stata completata.
E_INVALIDARG	Gli argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Un indice trigger non è un identificatore. Indica solo la posizione del trigger rispetto ai trigger correnti associati all'elemento di lavoro. Ad esempio, se si creano quattro trigger, verranno numerati da 0 a 3. Tuttavia, se il secondo trigger viene eliminato, i trigger rimanenti verranno numerati da 0 a 2. Si noti che l'indice del primo trigger è sempre 0 e l'indice dell'ultimo trigger è minore del numero totale di trigger per l'elemento di lavoro (TriggerCount -1).

È possibile recuperare il conteggio dei trigger usando IScheduledWorkItem::GetTriggerCount.

Esempio

Per un esempio di come recuperare la stringa di trigger di tutti i trigger associati a un'attività, vedere Recupero di stringhe trigger di esempio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mstask.h
Libreria	Mstask.lib
DLL	Mstask.dll
Componente ridistribuibile	Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95

Vedi anche

IScheduledWorkItem

Itask

Condividi tramite