SplDisable: Difference between revisions

Latest revision as of 04:35, 3 September 2025

This function is called to disable the OS/2 spooler. The spooler remains disabled across reboots. It can be re-enabled using SplEnable.

Note: There is currently no support for using this API to remotely disable a print spooler.

Syntax

SplDisable(pszComputerName, pReserved)

Parameters

pszComputerName (PSZ) - input: Name of the computer on which to disable the spooler.; This value currently must be NULL to disable the local spooler.
pReserved (PVOID) - input: Must be NULL. Reserved for future use.

Returns

rc (ULONG) - returns

Return codes.

0 Success

87 ERROR_INVALID_PARAMETER - An invalid buffer given.

0x4009 PMERR_SPL_SPOOLER_NOT_INSTALLED - The spooler is not enabled.

@@ Line 1: / Line 1: @@
-This function is called to disable the OS/2 spooler. The spooler remains disabled across reboots. It can be re-enabled using SplEnable.
+This function is called to disable the OS/2 spooler. The spooler remains disabled across reboots. It can be re-enabled using [[SplEnable]].
+;Note: There is currently no support for using this API to remotely disable a print spooler.
-; Note: There is currently no support for using this API to remotely disable a print spooler.
 == Syntax ==
-  SplDisable(pszComputerName, pReserved);
+  SplDisable(pszComputerName, pReserved)
 == Parameters ==
-; pszComputerName (PSZ) - input
+;''pszComputerName'' ([[PSZ]]) - input: Name of the computer on which to disable the spooler.
-: Name of the computer on which to disable the spooler.
+:This value currently must be NULL to disable the local spooler.
+;''pReserved'' ([[PVOID]]) - input: Must be NULL. Reserved for future use.
-:This value currently must be NULL to disable the local spooler.
-; pReserved (PVOID) - input
-: Must be NULL. Reserved for future use.
-== Returns ==
-; rc (ULONG) - returns : Return codes.
-* 0 Success
-:;ERROR_INVALID_PARAMETER(87)
-::An invalid buffer given.
-:;PMERR_SPL_SPOOLER_NOT_INSTALLED(0x4009)
-::The spooler is not enabled.
-== Sample ==
-<pre>
-#define INCL_SPL
-#define INCL_SPLBIDI
-#include <os2.h>
-PSZ      pszComputerName;  /*  Name of the computer on which to disable the spooler. */
-PVOID    pReserved;        /*  Must be NULL. Reserved for future use. */
-ULONG    rc;               /*  Return codes. */
-rc = SplDisable(pszComputerName, pReserved);
+==Returns==
-</pre>
+;''rc'' ([[ULONG]]) - returns: Return codes.
+::0 Success
+::87 ERROR_INVALID_PARAMETER - An invalid buffer given.
+::0x4009 PMERR_SPL_SPOOLER_NOT_INSTALLED - The spooler is not enabled.
 [[Category:Spl]]