Systemaufruf __pag_getid

Online bearbeiten

Zweck

Ruft den kcred_getpagid -Kernel-Service auf und gibt die PAG-ID für diesen PAG-Namen zurück

Syntax

int __pag_getid (name)
char *name;

Beschreibung

Bei einem PAG-Typnamen ruft __pag_getid den kcred_getpagid -Kernel-Service auf und gibt die PAG-Kennung für diesen PAG-Namen zurück.

Parameter

Element Beschreibung
Name Ein char * -Wert, der auf eine auf NULL endende Zeichenfolge mit maximal PAG_NAME_LENGTH_MAX Zeichen verweist.

Rückgabewerte

Bei erfolgreicher Ausführung wird ein Wert größer-gleich 0 zurückgegeben, der den PAG-Typ darstellt. Dieser Wert kann in nachfolgenden Aufrufen anderer PAG-Systemaufrufe verwendet werden, die einen Parameter Typ bei der Eingabe erfordern. Wenn dies nicht gelingt,-1 wird zurückgegeben und die Fehler Die globale Variable wird auf einen Wert gesetzt, der die Fehlerursache widerspiegelt.

Fehlercodes

Element Beschreibung
ENOENT Der Parameter Name verweist nicht auf einen vorhandenen PAG-Typ.
ENAMETOOLONG Der Parameter Name verweist auf eine Zeichenfolge, die länger als PAG_NAME_LENGTH_MAX ist.