Funzione RestoreDC (wingdi.h)

La funzione RestoreDC ripristina un contesto del dispositivo (DC) allo stato specificato. Il controller di dominio viene ripristinato eliminando le informazioni sullo stato di uno stack creato dalle chiamate precedenti alla funzione SaveDC .

Sintassi

BOOL RestoreDC(
  [in] HDC hdc,
  [in] int nSavedDC
);

Parametri

[in] hdc

Handle per il controller di dominio.

[in] nSavedDC

Stato salvato da ripristinare. Se questo parametro è positivo, nSavedDC rappresenta un'istanza specifica dello stato da ripristinare. Se questo parametro è negativo, nSavedDC rappresenta un'istanza relativa allo stato corrente. Ad esempio, -1 ripristina lo stato salvato più di recente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Ogni controller di dominio gestisce uno stack di stati salvati. La funzione SaveDC esegue il push dello stato corrente del controller di dominio nello stack di stati salvati. Tale stato può essere ripristinato solo allo stesso controller di dominio da cui è stato creato. Dopo il ripristino di uno stato, lo stato salvato viene eliminato e non può essere riutilizzato. Inoltre, tutti gli stati salvati dopo la creazione dello stato ripristinato vengono eliminati e non possono essere usati. In altre parole, la funzione RestoreDC popa lo stato ripristinato (e tutti gli stati successivi) dallo stack di informazioni sullo stato.

Requisiti

Vedi anche

Funzioni del contesto del dispositivo

Panoramica dei contesti del dispositivo

SaveDC