Condividi tramite


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