CreateSMSStatusMessage függvény

A Configuration Manager a CreateSMSStatusMessage függvény lefoglal egy állapotüzenet-objektumot, inicializálja azt, és lekér egy leírót.

Szintaxis

[C/C++]  
typedef DWORD (WINAPI *PROC_CREATESMSSTATUSMESSAGE)  
(  
      PHANDLE phStatusMessageObject,  
      LPCSTR  pszModuleName,  
      DWORD   dwID,  
      DWORD   dwWin32Error,  
      LPCSTR  pszInsStr1,  
      LPCSTR  pszInsStr2,  
      LPCSTR  pszInsStr3,  
      LPCSTR  pszInsStr4,  
      LPCSTR  pszInsStr5,  
      LPCSTR  pszInsStr6,  
      LPCSTR  pszInsStr7,  
      LPCSTR  pszInsStr8,  
      LPCSTR  pszInsStr9,  
      LPCSTR  pszInsStr10   
);  

Paraméterek

phStatusMessageObject
Adattípus: PHANDLE

Minősítők: [be, ki]

Mutató az objektum fogópontjára. Bemenetként adjon meg egy leírót az állapotüzenet létrehozásához. A függvény sikeres visszatérése esetén a paraméter a létrehozott objektumot jelzi. Ha a függvény nem jár sikerrel, a bemeneti érték változatlan marad.

pszModuleName
Adattípus: LPCSTR

Minősítők: [in]

Mutasson az állapotüzenet-modul nevére, amely egy null értékű ASCII-sztring, amely az alkalmazásüzenetek megjelenítési sztringjét tartalmazó DLL-t jelöli. A modul neve megjelenik az Állapotüzenet-megjelenítőben és a Windows NT eseménymegtekintő az állapotüzenet forrásaként.

dwID
Adattípus: DWORD

Minősítők: [in]

Állapotüzenet azonosítója.

dwWin32Error
Adattípus: DWORD

Minősítők: [in]

Választható. A Win32 függvény által visszaadott Win32-hibakód GetLastError.

pszInsStr1
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet beszúrási sztringjére 1, sztring nélkül pedig a következőre null : .

pszInsStr2
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet 2. beszúrási sztringjére vagy a gombra null karakterlánc nélkül.

pszInsStr3
Adattípus: LPCSTR

Selejtezők: [in]

Mutató az állapotüzenet 3. beszúrási sztringjére vagy a 3 null . sztringre karakterlánc nélkül.

pszInsStr4
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet 4. beszúrási sztringjére vagy a gombra null karakterlánc nélkül.

pszInsStr5
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet 5. beszúrási sztringjére vagy a mutatóra null karakterlánc nélkül.

pszInsStr6
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet 6. beszúrási sztringjére, vagy a ra null karakterlánc nélkül.

pszInsStr7
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet 7. beszúrási sztringjére, vagy a mutatóra null karakterlánc nélkül.

pszInsStr8
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet beszúrási sztringjére 8 vagy a ra null karakterlánc nélkül.

pszInsStr9
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet 9. beszúrási sztringjére vagy a null gombra karakterlánc nélkül.

pszInsStr10
Adattípus: LPCSTR

Minősítők: [in]

Mutató az állapotüzenet beszúrási sztringjére 10, vagy a to értékre null karakterlánc nélkül.

Értékek visszaadott értéke

Ez a függvény az alábbi táblázatban szereplő értékek egyikét adja vissza.

Érték	Leírás
SMSSTATMSG_SUCCESS	Az objektum létrehozása sikerült.
SMSSTATMSG_OUT_OF_MEMORY	A függvény nem tudott elegendő memóriát lefoglalni az objektum létrehozásához.
SMSSTATMSG_ERROR_INVALID_MODULE_NAME	A hívó megadott null vagy egy sztring, amely túllépte SMSSTATMSG_MAX_MODULE_NAME_LENGTH karaktert a pszModuleName paraméternél.
STATMSG_ERROR_INVALID_INSSTR	A hívó olyan sztringet adott meg, amely túllépte SMSSTATMSG_MAX_INSSTR_LENGTH karaktert az egyik beszúrási sztringparaméter esetében.
SMSSTATMSG_ERROR_UNKNOWN	A függvény ismeretlen hibát észlelt az objektum létrehozásakor.

Megjegyzések

Az Smscstat.h az alábbi #define tartalmazza a Win32 függvény GetProcAddresshasználatával történő híváshozCreateSMSStatusMessage.

#define PROCNAME_CREATESMSSTATUSMESSAGE "CreateSMSStatusMessage"  

A függvény meghívásához rendszergazdai jogosultságok szükségesek.

Csak akkor hívjon CreateSMSStatusMessage , amikor szükség van egy állapotüzenet jelentésére. Ennek a szabálynak az az oka, hogy az állapotüzenet egy létrehozáskor beállított időbélyeget tartalmaz.

A függvény meghívásakor a használatával phStatusMessageObject adjon meg egy objektumot, amelyet a többi állapotüzenet-jelentési függvény meghívásakor fog használni. Vegye figyelembe, hogy a leíróhoz társított objektum lefoglalásának megszüntetésének egyetlen módja a ReportSMSStatusMessage függvény meghívása, amely elküldi az állapotüzenetet a Configuration Manager állapotrendszernek. Ezt a leírót ne adja át a Win32 függvénynek CloseHandle vagy más hasonló függvénynek.

A paraméterhez pszModuleName megadott modulnév nem a DLL neve, hanem egy Configuration Manager modul neve. A Configuration Manager helykiszolgáló a modulnevek DLL-nevekre való leképezését tartalmazza. Az ügyfélösszetevők például az Configuration Manager ügyfélmodul nevének használatával jelentik az állapotüzeneteket. A helykiszolgáló tisztában van azzal, hogy a Configuration Manager-ügyfél megfelel a fájl Climsgs.dll.

A modul neve nem honosítható más nyelvekre, mert a Configuration Manager rendszergazda az összetevő neve alapján hoz létre lekérdezéseket és szűrési szabályokat. Ez segít a rendszergazdának abban, hogy gyorsan lekérte az adott állapotüzeneteket, és konfigurálja a Configuration Manager az állapotüzenetek speciális kezelésére.

A függvény meghívása során a paraméterrel adja meg az dwID állapotüzenet azonosítóját. Az alkalmazás állapotüzenetek Configuration Manager jelentésére való előkészítésének részeként egy .mc fájlt hoz létre, amely meghatározza az összes üzenetet. A fájl fordítása egy .h fájlt hoz létre, amely minden definiált állapotüzenethez #define tartalmaz. Üzenetazonosítóként meg kell adnia a #define szimbólumot. Amikor az Állapotüzenet-megjelenítő vagy a Windows NT eseménymegtekintő megjeleníti az üzenetet, a megadott üzenetazonosítóval megkeresi az üzenet szövegét a kapcsolódó DLL-ben.

A paraméterben dwWin32Error megadhat egy nem kötelező Win32 hibakódot, amelyet a Win32 GetLastErrorhívása ad vissza. Amikor az Állapotüzenet-megjelenítő vagy a Windows NT eseménymegtekintő megjeleníti az állapotüzenetet, az az állapotüzenetben szereplő 12. beszúrási sztringet (%12) a következő szövegre cseréli: Az operációs rendszer X: Y hibát jelzett. Ahol X az itt megadott hibakód, az Y pedig a hibakódhoz társított Win32-hibaszöveg. Az 5-ös hibakód például a következő: "Hozzáférés megtagadva".

Általában egy Win32-es hibakódot fog megadni, amikor egy állapotüzenetet jelent közvetlenül a Win32-függvény hibája után. Adja meg a 0 értéket, amely jelzi az állapotrendszernek, hogy nincs Win32-hibakód társítva az állapotüzenethez, ebben az esetben a 12. beszúrási sztring üres.

A hívása CreateSMSStatusMessage nulla és 10 null értékű ASCII-beszúrási sztring között tud megadni. Ezek a sztringek az állapotüzenet definíciójában szereplő feloldókaraktenek felelnek meg: %1, %2, %3 stb. Amikor az Állapotüzenet-megjelenítő vagy a Windows NT eseménymegtekintő megjeleníti az állapotüzenetet, a feloldósorozatokat lecseréli a függvényhez megadott értékekre.

Követelmények

Smscstat.dll.

Futtatókörnyezetre vonatkozó követelmények

További információ: Configuration Manager client runtime requirements (Ügyfél futtatókörnyezeti követelményeinek Configuration Manager).

Fejlesztési követelmények

További információ: Configuration Manager ügyfélfejlesztési követelmények.

Lásd még

Állapotüzenet-függvényekSMSCSTAT.DLL