Interfaccia IPrincipal (taskschd.h)

Fornisce le credenziali di sicurezza per un'entità. Queste credenziali di sicurezza definiscono il contesto di sicurezza per le attività associate all'entità.

Ereditarietà

L'interfaccia IPrincipal eredita dall'interfaccia IDispatch.

Metodi

L'interfaccia IPrincipal include questi metodi.

IPrincipal::get_DisplayName Ottiene o imposta il nome dell'entità. (Get)
IPrincipal::get_GroupId Ottiene o imposta l'identificatore del gruppo di utenti necessario per eseguire le attività associate all'entità. (Get)
IPrincipal::get_Id Ottiene o imposta l'identificatore dell'entità. (Get)
IPrincipal::get_LogonType Ottiene o imposta il metodo di accesso di sicurezza necessario per eseguire le attività associate all'entità. (Get)
IPrincipal::get_RunLevel Ottiene o imposta l'identificatore utilizzato per specificare il livello di privilegio necessario per eseguire le attività associate all'entità. (Get)
IPrincipal::get_UserId Ottiene o imposta l'identificatore utente necessario per eseguire le attività associate all'entità. (Get)
IPrincipal::p ut_DisplayName Ottiene o imposta il nome dell'entità. (Put)
IPrincipal::p ut_GroupId Ottiene o imposta l'identificatore del gruppo di utenti necessario per eseguire le attività associate all'entità. (Put)
IPrincipal::p ut_Id Ottiene o imposta l'identificatore dell'entità. (Put)
IPrincipal::p ut_LogonType Ottiene o imposta il metodo di accesso di sicurezza necessario per eseguire le attività associate all'entità. (Put)
IPrincipal::p ut_RunLevel Ottiene o imposta l'identificatore utilizzato per specificare il livello di privilegio necessario per eseguire le attività associate all'entità. (Put)
IPrincipal::p ut_UserId Ottiene o imposta l'identificatore utente necessario per eseguire le attività associate all'entità. (Put)

Commenti

Quando si specifica un account, ricordarsi di usare correttamente la barra rovesciata doppia nel codice per specificare il dominio e il nome utente. Ad esempio, usare DOMAIN\UserName per specificare un valore per la proprietà UserId .

Quando si legge o si scrive XML per un'attività, le credenziali di sicurezza per un'entità vengono specificate nell'elemento Principal dello schema Dell'utilità di pianificazione.

Se un'attività viene registrata usando lo strumento della riga di comando at.exe e questa interfaccia viene usata per recuperare informazioni sull'attività, la proprietà LogonType restituirà 0, la proprietà RunLevel restituirà 0 e la proprietà UserId restituirà NULL.

Esempio

Per altre informazioni e codice di esempio per questa interfaccia, vedere Esempio di trigger temporale (C++) o Esempio di trigger di registrazione (C++).

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	taskschd.h

Vedi anche

ITaskDefinition

Proprietà principal di ITaskDefinition

Interfacce dell'utilità di pianificazione